Node / markqvist / pycodec2.git rns://e35de29a61974cd952fde3fe9c8500d5/markqvist/pycodec2.git

🗀 Files • ☸ Work (0) • 🖹 Commits (102) • ⑃ Branches (1) • ⌆ Tags (0) • ♥ Thanks (0)

Pycodec2 requires [Codec 2][codec2].

On Linux, I recommend using the distro's package-manager, e.g., on

Arch/Manjaro: T383838pacman -Syuu codec2, so that Codec2's assets land in standard

searchable directories for T383838python setup.py to use.

On macOS, you may use [the Homebrew

formula](https://formulae.brew.sh/formula/codec2#default).

You can install the library using PyPI (the easiest option) or from source.

To install the library from PyPI, run:

T282828

To install the library from source, see building instructions in T383838DEV.md. You

can then install the wheel with:

T282828

Pycodec2 3.\ is compatible with Codec 2 1.2.\.

Pycodec2 2.\ is compatible with Codec 2 1.0.\.

Pycodec2 1.0.\* is compatible with Codec 2 at 0.9.2+ versions.

If your Codec 2 version is older than 0.9.2, then try

pycodec2-old package.

For more information on potential compatibility problems, check out [this

issue](https://github.com/gregorias/pycodec2/issues/8).

T383838example.py implements a basic script that uses Codec 2 to encode and deencode

a sample. Use the following steps to run an end-2-end scenario (dev/rune2etest

implements steps 2-5).

1. Download a sample .wav file, e.g., trashcan.

2. Convert the .wav to a raw mono-channel 8kHz format, e.g.,

sox trashcan.wav -e signed-integer -b 16 trashcan.raw channels 1 rate 8000

3. Compile pycodec2

python setup.py build_ext --inplace

4. Run T383838example.py

python example.py trashcan.raw

5. Convert T383838output.raw

sox -r 8000 -e signed-integer -b 16 output.raw output.wav

Now you can listen to T383838output.wav.

[Codec 2][codec2] assumes that input files use:

• 8kHz bitrate,

• 16-bit width samples,

• a single channel.

For a list of currently supported modes, look for T383838_modes in

T383838pycodec2/pycodec2.pyx.

This library is considered complete. Please notify me or send a pull request on

GitHub if you notice any bugs.

[codec2]: http://www.rowetel.com/blog/?page_id=452